home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / moretim1.zip / MORETIME.DOC < prev    next >
Text File  |  1991-12-19  |  6KB  |  131 lines
  1.  +--------------------------[ MoreTime Ver 1.10 ]----------------------------+
  2.  |  Written By Gary Meeker 12/18/91                        Updated 12/19/91  |
  3.  |  SYSOP: SHARP Technical Support Line BBS               Lawrenceville, GA  |
  4.  |         (404) 962-1788                 300/1200/2400/9600 Baud. 24 Hours  |
  5.  +---------------------------------------------------------------------------+
  6.  V1.0 12/18/91 - Initial release
  7.  V1.1 12/19/91 - Noticed I left off the LEN = 25 for the database file.
  8.                - Removed PCBDOOR.TXT from .CFG file and onto command line
  9.                  to make multi-node setup easier
  10.                - Added Bytes Increase value (based on 2400 baud)
  11.  -----------------------------------------------------------------------------
  12.  
  13. This was created to answer the needs of the following:
  14.  
  15.    Here's the need:
  16.  
  17.         A door called MORETIME to allow certain new users to enter a
  18. specific password (which they will know in advance) and raise the
  19. amount of time and bytes they are allowed.
  20.  
  21.    Here's the scenario:
  22.  
  23.         The average new user is allowed to download 50K and has a 30
  24. min/day time limit.  Some special folks need to call into the BBS and
  25. download a 100K file and need more time to do it in.  They can't take
  26. the time to use the regular VERIFY door to raise their access, since
  27. they are calling long distance, so they've called me in advance to ask
  28. me how to log on to my BBS and download the file they need.  Once they
  29. log on as a completely new user, and get to the main board, they enter
  30. MORETIME and are prompted for a password.  Since I've already spoken
  31. to them and given them the special password, they enter that.  The
  32. door writes to PCBOARD.SYS and gives them 90 minutes per day and
  33. unlimited access to the files (or simply raises their security level).
  34.  
  35.    Here's the question:
  36.  
  37.         Does such a door already exist, or would someone with some
  38. programming expertise like to take a swing at it?
  39.  
  40.         I've read DEVELOP.SYS and while the programming logic is
  41. pretty obvious to me, the technique for writing it is beyond my
  42. present level of experience.  Any comments would be appreciated.
  43. -----------------------------------------------------------------------------
  44.  
  45. Here's a simple program to do the job.
  46.  
  47. Setup the door with PCBSETUP and install a PASSWORD if that fits your
  48. needs. For fastest access, use the SHELL method (no swap needed) and
  49. leave USERS.SYS & DOOR.SYS set to NO.
  50.  
  51. The door file should look like this:
  52.  
  53. MORETIME C:\PCB\
  54.  
  55. or
  56.  
  57. MORETIME %PCBDRIVE%%PCBDIR%
  58.  
  59. or
  60.  
  61. CD \MORETIME
  62. MORETIME %PCBDRIVE%%PCBDIR%
  63. CD %PCBDIR%
  64.  
  65.  
  66. This should work for multiple nodes just fine. (note: you can not use
  67. the swap option in the door as the %PCBDRIVE% & %PCBDIR% variables will
  68. not be present (unless you are settiing them manually in your BOARD.BAT
  69. file.)
  70.  
  71. The file MORETIME.EXE should be located in the path or current directory
  72. and the file MORETIME.CFG must be in the current path or change the batch
  73. file to change to the directory before running MORETIME as in example 3.
  74.  
  75. The MORETIME.CFG file should contain the following 5 lines
  76.  
  77. MORETIME.DAT
  78. MORETIME.BAD
  79. MORETIME.ADD
  80. 60
  81. 100
  82.  
  83. Line 1:Drive:Path\FileName of the User Data base of Users who have used the door
  84. Line 2:Drive:Path\FileName of the text to display if a User has already accessed
  85.        the Door and is refused access again.
  86. Line 3:Drive:Path\FileName of the text to display if a User is granted the
  87.        additional time & bytes.
  88. Line 4:The Amount of additional Time to be granted.
  89. Line 5:The Amount of additional KBytes to be granted. (Based on 2400 Baud)
  90.        This value will be adjusted according to the actual connect speed of the
  91.        User. (This will not be allowed to exceed the Daily limit set in PWRD
  92.        so it doesn't work the way I wanted it to, I will see how to get this
  93.        to work correctly)
  94.  
  95. You may 'CLEAR' the database at any time (like in an event) to allow users to
  96. reaccess the door another day, or just leave it going to allow a single access
  97. to the door. You can leave the line blank if you don't want to limit use of the
  98. door. To 'CLEAR' the database, do not delete the file, but set it to ZERO BYTES
  99. by doing a
  100.  
  101. REM > MORETIME.DAT
  102.  
  103. If the file does not exist at all, then the program will not work right. Before
  104. opening the file, the existence of the file is checked for.
  105.  
  106. Files are not opened in share mode but as the program is going to run so fast,
  107. it should not present any problems as multiple users would have to try to run
  108. the door at the exact same moment.
  109.  
  110. The program returns the following ErrorLevel codes.
  111.  
  112. 20 = The Config file MORETIME.CFG could not be found.
  113. 10 = The PCBOARD.SYS fie specified on the Command Line could not be found.
  114.  1 = The User was not granted more time due to being found in database file.
  115.  0 = The User was granted the additional time.
  116.  
  117. The file was compiled with PDQ for small size and fast operation. The source is
  118. included (although unless you have Crescent's QuickPack Professional libraries
  119. you won't be able to compile it without changing the references to the 3
  120. routines I used from the Library.
  121.  
  122. Since PCBoard does the displaying of either of the two text files, you may use
  123. @Xnn color codes or any of the @variable@ codes you would like. This allows
  124. displaying useful information to the user (as in the sample files).
  125.  
  126. If you have any questions, give me a call at my BBS
  127.  
  128. SHARP Technical Support Line BBS - (404) 962-1788  - ATI 9600 etc/E V.32
  129.  
  130. Gary Meeker
  131.